home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-2.iso / extra_2 / fmtrk145.zip / FMTRK.DOC < prev    next >
Text File  |  1995-11-29  |  18KB  |  340 lines
  1.              █▀▀▀ ██ ██       █              █ ▄  ▄
  2.              █▀▀  █ █ █  ▀▀  ▀█▀ █▀ █▀█  █▀▀ ██  █▄▀ █▀  
  3.            █ ▀    ▀   ▀       ▀▀ ▀  ▀▀▀▀ ▀▀▀ ▀ ▀ ▀▀▀ ▀  █
  4.            ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  5.  
  6.                      FM Tracker - Version 1.45
  7.            Copyright (C) 1993,1994,1995 Sagitta Software
  8.  
  9. FM Tracker is a program, which can be used for composing and playing
  10. polyphonic music. It uses the FM synthesizer chip on an AdLib, Sound Blaster 
  11. or compatible to generate sounds. The advantages with the FM music contra 
  12. music created with digital samples are: 
  13.         - Little disk/memory space required
  14.         - Almost no CPU power required (not when using GUS however; GUS won't
  15.           need more CPU power for music consisting of digital samples)
  16.         - Digital samples can somtimes sound more or less metallic
  17. An inconvenience should also be mentioned: All sounds are synthetic. Therefore
  18. instruments may sound unrealistic.
  19.  
  20. ───────────────────────────Copyright notice────────────────────────────────────
  21. THIS SOFTWARE IS DISTRIBUTED AS FREEWARE. THAT IS, THIS PRODUCT CAN BE COPIED
  22. AND GIVEN AWAY, AS LONG AS IT IS NOT TAKEN ANY CHARGE FOR IT, EXCEPT OF OWN
  23. EXPENCES. WHEN GIVEN AWAY, THE FOLLOWING FILES MUST BE INCLUDED, AND THEY HAVE
  24. TO BE UNMODIFIED:
  25.       FMTRK.EXE
  26.       FMTRK.DOC
  27. ──────────────────────────────Disclaimer───────────────────────────────────────
  28. SAGITTA SOFTWARE MAKES NO WARRANTY, EITHER EXPRESS OR IMPLIED, WITH RESPECT TO
  29. THIS SOFTWARE, ITS QUALITY, PERFORMANCE, MERCHANTABILITY OR FITNESS FOR ANY
  30. PARTICULAR PURPOSE. THE ENTIRE RISK AS TO ITS QUALITY AND PERFORMANCE IS WITH
  31. THE USER. IN NO EVENT WILL SAGITTA SOFTWARE BE LIABLE FOR DIRECT, INDIRECT,
  32. INCIDENTAL, OR CONSEQUENTIAL DAMAGES RESULTING FROM ANY DEFECT IN THE PROGRAM
  33. EVEN IF SAGITTA SOFTWARE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  34. ───────────────────────────────────────────────────────────────────────────────
  35.  
  36. Files in this package:
  37. ──────────────────────
  38. FMTRK.EXE      FM Tracker v1.45
  39. FMTRK.DOC      Documentation for FM Tracker
  40. FMTI.DOC       FM Tracker Interface Version History
  41. FMTP.EXE       FM Tracker Player v1.25
  42. FMTP.DOC       Documentation for FM Tracker Player
  43.  
  44. System requirements: 
  45.   - IBM PC or compatible, preferably with an 80286 processor or better
  46.   - AdLib / Sound Blaster sound card or compatible
  47.   - VGA card (FM Tracker uses the text mode with 50 lines)
  48.   - DOS 4.0 or newer
  49. Also recommended: Extended keyboard
  50.  
  51.              
  52.  
  53.              How to make music
  54.              ─────────────────
  55. The first thing to do before making the music, is to decide what kind of
  56. track/channel format to use. The two choices are: 
  57.              9 melodic channels
  58.              6 melodic + 5 percussive channels
  59.  
  60. The 5 percussive instruments are:
  61.              bass drum (track 6)
  62.              snare drum (track 7)
  63.              tom tom (track 8)
  64.              top cymbal (track 9)
  65.              hihat (track 10)
  66.  
  67. You don't necessarily have to choose the one with 5 percussive channels even
  68. if you are going to use percussive instruments in the song, because it is
  69. also possible to use that kind of instruments in a melodic channel. But it
  70. might be more difficult to create a good percussive instrument for a melodic
  71. track. In that case, use the 6 mel.+5 perc. track format.
  72.  
  73. Pattern examples:
  74.                           9 melodic tracks
  75.  ┌───dec─────────────────────Line number──────────────────────────hex──────┐
  76.  │                                                                         │
  77.  │ Track 0 Track 1 Track 2 Track 3 Track 4 Track 5 Track 6 Track 7 Track 8 │
  78.  │                                                                         │
  79. 07 --- 000 --- 000 E-5 E81 --- 000 --- 000 --- 000 --- 000 B-4 000 --- 000 07
  80. 08 --- 000 --- 000 └┤│ └┼┘ --- 000 --- F03 --- 000 --- 000 --- 000 --- 000 08
  81. 09 C#2 000 --- 000 -││ 0│0 --- 000 --- 000 --- 000 --- 000 --- 000 --- 000 09
  82. 10 --- 000 --- 000 -││ 0│0 --- 000 --- 000 --- 000 --- 000 --- 000 --- 000 0A
  83.           ┌─────────┘└┐ │ 
  84.           │           │ └─────┐
  85.          note      octave     └special effect codes
  86.           
  87.  
  88.                    6 melodic + 5 percussive tracks
  89.  ┌───dec─────────────────────Line number──────────────────────────hex───────┐
  90.  │                                                                          │
  91.  │ Track 0 Track 1 Track 2 Track 3 Track 4 Track 5  BD   SD   TT   TC   HH  │
  92.  │                                                                          │
  93. 07 --- 000 --- 000 E-5 E81 --- 000 --- 000 --- 000 -000 -000 -000 -000 -000 07
  94. 08 --- 000 --- 000 -││ └┼┘ --- 000 --- F03 --- 000 -000 *000 -000 -000 -000 08
  95. 09 C#2 000 --- 000 -││ 0│0 --- 000 --- 000 --- 000 -000 │E01 -000 -000 -000 09
  96. 10 --- 000 --- 000 -││ 0│0 --- 000 --- 000 --- 000 -000 │└┼┘ -000 -000 -000 0A
  97.           ┌─────────┘│  │                               │ │
  98.           │         ┌┘  │      make percussive sound────┘ │
  99.         note    octave  └────special effect codes─────────┘
  100.  
  101. BD=bass drum   SD=snare drum   TOM=tom tom   TC=top cymbal   HH=hihat
  102.  
  103. When you have decided which format to use, you should make one or more
  104. instruments. Press F3 to enter the instrument editor. There are 12 entries if
  105. you edit a melodic instrument. Each entry consists of a two-digit hex value.
  106. This hex-value can often be divided into under-entries. They are shown at the
  107. bottom of the instrument editor window. Press 'I' if you want to enter that
  108. part, but as you get more experienced, you will probably prefer to enter the
  109. instrument's data directly (two-digit hex entries).
  110.  
  111. You can also use the instruments from an other song. Then load the song (F9) 
  112. and delete it from memory (Alt-D). Answer no at "Clear instruments too".
  113.  
  114. When you have some instruments ready, you can start to enter some notes. Press
  115. F2 to move over to the pattern editor. Here the keyboard works as an two-row 
  116. organ.
  117. The first row is:
  118.  
  119.   S   D       G   H   J       L   ¥            black
  120. Z   X   C   V   B   N   M   ,   .   -          white
  121. which in notes equals to:
  122.   C#  D#      F#  G#  A#      C#  D#
  123. C   D   E   F   G   A   B   C   D   E
  124.  
  125.  
  126. The second row is:
  127.   
  128.   2   3       5   6   7       9   0       \    black
  129. Q   W   E   R   T   Y   U   I   O   P   Å      white
  130. which in notes equals to:
  131.   C#  D#      F#  G#  A#      C#  D#     F#
  132. C   D   E   F   G   A   B   C   D   E  F
  133.  
  134. Use Tab/Shift-Tab to move to the next/previous track.
  135.  
  136. Before you play the music, you have to tell FM Tracker in what order the
  137. patterns are to be played. Press F7. The same patterns can be repeated as many
  138. times as you like. If you type in pattern FF, the song will start from the 
  139. beginning, because pattern number FF doesn't exist. 
  140.  
  141. Then the song is ready to be played. Press F5 to do so. Press F10 to save it.
  142.  
  143.  
  144.                   Files
  145.                   ─────
  146. The songs that you write in FM Tracker are saved in the FMT-format. The
  147. FMT-format is constantly improved. That is, if you load a song which is saved
  148. with an FMT version newer than the FM Tracker version you are using, you will
  149. either get a warning, or FM Tracker won't recognize the file. The result if
  150. you get a warning, might be that the song doesn't sound properly. If this 
  151. happens, get yourself a newer FM Tracker version.
  152.  
  153. It is also possible to load HSC files (but no saving). If you want to load such
  154. a file, type in the full HSC file name with the extention. The extention for an
  155. HSC file has to be HSC. That is because there is no 100% safe way to recognize
  156. an HSC file.
  157.  
  158.               Special effects
  159.               ───────────────
  160. As with MOD-tracker, it is possible to use special effects in FM Tracker, 
  161. such as setting the volume and the tempo. Special effects are entered in the 
  162. three last hexadecimal digits (nibbles) in each track entry. The first nibble,
  163. sometimes together with the second, and sometimes even with the third,
  164. indicates the function. The rest of the nibbles form the argument(s) for the
  165. function. When nibble 1 is E and nibble 2 is F, there are no argument nibbles.
  166. Nibble 3 specifies a function. To call this function 8xx is used, where xx is 
  167. the argument.
  168.  
  169. Here is a description of the special effect codes available in this version
  170. of FM Tracker:
  171.  
  172. │ Nibble 1 │ Nibble 2 │ Nibble 3 │  Description
  173. ├──────────┼──────────┼──────────┼────────────────────────────────────────────
  174. │    1     │   0-F    │   0-F    │ Portamento up.
  175. │    2     │   0-F    │   0-F    │ Portamento down.
  176. │    3     │ unused   │ unused   │ Portamento to tone/Triggerless note change.
  177. │          │          │          │ Note that the two last nibbles aren't used 
  178. │          │          │          │ (for the present).
  179. │    4     │   0-F    │   0-F    │ Vibrato. Nibble 2 specifies the vibrato
  180. │          │          │          │ speed, nibble 3 specifies the amount of
  181. │          │          │          │ vibrato.                 
  182. │    8     │   0-F    │   0-F    │ Replaceable function (see Special Effect
  183. │          │          │          │ Code EF).
  184. │    9     │   0-F    │   0-F    │ Set instrument. In FM Tracker you set the
  185. │          │          │          │ instrument with a special effect code. In
  186. │          │          │          │ a "normal" tracker this is entered after
  187. │          │          │          │ each note.
  188. │    A     │   0-F    │   0-F    │ Volume slide. Nibble 2 specifies the value
  189. │          │          │          │ that should be added to the current volume,
  190. │          │          │          │ nibble 3 specifies the value, which is to
  191. │          │          │          │ be subtracted.
  192. │    B     │   0-7    │   0-F    │ Jump to order. Nibble2+3 specifies which
  193. │          │          │          │ number in the order list to jump to.
  194. │    C     │   0-4    │   0-F    │ Set note volume. The higher value in 
  195. │          │          │          │ nibble 2+3, the louder volume.
  196. │    D     │   0-3    │   0-F    │ Break pattern, and jump to the line number
  197. │          │          │          │ indicated by nibble 2 and 3.
  198. │    E     │    0     │   0-F    │ Stop sound. Nibble 3 specifies how long to
  199. │          │          │          │ delay before stopping the sound.
  200. │    E     │    1     │   0-1    │ Freeze/Unfreeze sound. If Nibble 3 = 1, the
  201. │          │          │          │ sound will freeze, when set to 0, it will 
  202. │          │          │          │ unfreeze. When the sound in a track is 
  203. │          │          │          │ freezed, it will stop changing - it will
  204. │          │          │          │ just keep the same volume level until
  205. │          │          │          │ unfreezed, or aborted by a new note.
  206. │          │          │          │ Portamento to note (SEC 3) will not
  207. │          │          │          │ unfreeze the sound.
  208. │    E     │    5     │   0-F    │ Set fade speed (0-slowest, F-fastest)
  209. │    E     │    8     │   0-3    │ Set amplitude/vibrato depth. Only the two
  210. │          │          │          │ least significant bits of nibble 3 are used.
  211. │          │          │          │ Bit 0:Vibrato depth, Bit 1:Amplitude depth.
  212. │          │          │          │ The depth is largest when the bit is set.
  213. │    E     │    9     │   1-F    │ Note retrigger. Nibble 3 specifies how long
  214. │          │          │          │ to delay before retriggering the note. This
  215. │          │          │          │ effect applies only to one line.
  216. │    E     │    A     │   0-F    │ Set operator 1 output level.
  217. │    E     │    B     │   0-F    │ Set operator 2 output level.
  218. │    E     │    D     │   1-F    │ Delay note. Nibble 3 specifies how long to
  219. │          │          │          │ delay before triggering the note. This
  220. │          │          │          │ effect applies only to one line.
  221. │    E     │    E     │   0-F    │ Delay pattern. Nibble 3 specifies how many
  222. │          │          │          │ extra notes to delay at the current line
  223. │          │          │          │ before proceeding to the next.
  224. │    E     │    F     │          │ Set replaceable function. This code will
  225. │          │          │          │ tell FM Tracker which function to use when
  226. │          │          │          │ code 8xx appears. This will only affect the
  227. │          │          │          │ current track, so the interpretation of
  228. │          │          │          │ function 8 may vary from track to track.
  229. │    E     │    F     │    0     │ Set general (global) volume.
  230. │    E     │    F     │    1     │ Set operator 1 level (fine)
  231. │    E     │    F     │    2     │ Set operator 2 level (fine)
  232. │    E     │    F     │    3     │ Fade music.
  233. │          │          │          │ Nibble2+Nibble3 = Destination Volume
  234. │          │          │          │ e.g. The code 800 will fade the music down
  235. │          │          │          │ to 0, the code 825 will fade the music up
  236. │          │          │          │ or down to 25Hex.
  237. │    F     │   0-1    │   0-F    │ Set tempo. When the two last nibbles are 
  238. │          │          │          │ less than 20Hex, the tempo is set. 0 is the
  239. │          │          │          │ fastest, 1FHex is the slowest.
  240. │    F     │    2     │   0-F    │ Set Clock Interrupt Speed. Usually the
  241. │          │          │          │ timer interrupt is called 18.2 times per
  242. │          │          │          │ second (18.2 Hz). This function allows you
  243. │          │          │          │ to change this. The value 20Hex sets the
  244. │          │          │          │ frequency to normal (18.2 Hz), 21Hex
  245. │          │          │          │ doubles it, 22Hex, three-doubles, 23Hex
  246. │          │          │          │ four-doubles and so on. In other words, 
  247. │          │          │          │ this will affect the playing speed, since
  248. │          │          │          │ FM Tracker uses the clock interrupt to play
  249. │          │          │          │ the music.
  250. └──────────┴──────────┴──────────┴────────────────────────────────────────────
  251.  
  252.               The instruments
  253.               ───────────────
  254. The melodic instruments are set with 12 bytes. You may make an instrument by
  255. typing in these bytes directly, but you might think it is a bit difficult in 
  256. the beginning. Then move over to the detailed area by pressing 'I'.
  257. Here is a description of these bytes:
  258.  
  259. AMP/VIB/EG/KSR/Multi Operator 1/2:
  260. ----------------------------------
  261.            Bit 7: Enable Amplitude Modulation if set.
  262.            Bit 6: Enable Vibrato if set.
  263.            Bit 5: EG Type: If not set, the sound starts releasing right after 
  264.                   hitting the sustain phase. Otherwise the sustain level is 
  265.                   preserved until the sound is released with "rel" or special
  266.                   effect code E0x.
  267.            Bit 4: Keyboard Scaling Rate: If set, the sound's envelope is 
  268.                   foreshortened as the pitch rises.
  269.            Bits 3-0: The operator's frequency is multiplied with the number 
  270.                      in these bits.
  271.  
  272.  
  273. KSL/Output Level Operator 1/2:
  274. ------------------------------
  275.            Bits 7-6: Makes the sound's level decrease as it rises in pitch.
  276.                      00 means no decrease
  277.                      11 is the highest decrease
  278.            Bits 5-0: Sets the operator's sound level. 0 is the loudest, 3FHex
  279.                      is the softest.
  280.  
  281.  
  282. Attack/Decay Operator 1/2:
  283. --------------------------
  284.    Most significant nibble:  Sets the attack rate. 0:slowest/never, F:fastest
  285.    Least significant nibble: Sets the decay rate. 0:slowest/never, F:fastest
  286.  
  287. Sustain/Release Operator 1/2:
  288. -----------------------------
  289.    Most significant nibble:  Sets the sustain level. 0: loudest, F:softest
  290.    Least significant nibble: Sets the release rate. 0: slowest/never, F:fastest
  291.  
  292.  
  293. Feedback/Alg:
  294. -------------
  295.    Bits 3-1: Sets the feedback level on operator 1. 0 is no feedback, 7 is 
  296.              max feedback.
  297.    Bit 0: If not set, operator 1 modulates operator 2. If set both operators
  298.           make sound directly.
  299.  
  300. Waveform Operator 1/2:
  301. ----------------------
  302.    Bits 0 and 1 is used to make four different waveforms.
  303.    Both bits set to 0 is the standard waveform.
  304.  
  305. Finetune:
  306. ---------
  307.    The 11 bytes described above are set in the hardware. The finetune is
  308.    unique to FM Tracker. The bytes that sets the hardware are unsigned. This
  309.    byte is signed. The sound can be finetuned up or down. For values above 0
  310.    it is tuned up. For values below 0 (above 7FHex, FFHex = -1, FEHex = -2)
  311.    it is tuned down.
  312.  
  313. The 5 percussive instrument types are a bit different:
  314. The bassdrum has the same parameters as an ordinary instrument, except that
  315. there are no entries for the Feedback/Alg and the Finetune. A bassdrum
  316. therefore requires 10 bytes.
  317. The snare drum, tom tom, top cymbal and hihat has 5 parameter entries. The 
  318. only difference from the bassdrum is that these instrument types have only
  319. one operator, while the bassdrum has two.
  320. But you have to be aware of this when using percussive tracks: 
  321. The AMP/VIB/EG/KSR/Multi field for one instrument type may affect another 
  322. instrument type. The top cymbal AMP/VIB(...) won't just apply to the top 
  323. cymbal, but to the hihat as well. The hihat AMP/VIB(...) will, in addition to 
  324. the hihat itself, affect both the top cymbal and the snare drum.
  325. Gee, was it really neccesarry to make it that complicated and confusing???
  326. I certainly would like to have a word with the designers of the FM-chip. :-)
  327.  
  328. ──────────────────────────────────────────────────────────────────────────────
  329. Press F1 in FM Tracker for a complete key overview and other information.
  330. ──────────────────────────────────────────────────────────────────────────────
  331.  
  332. Address for bug reports, tips for future releases, questions, e.t.c.:
  333.  
  334. MORTEN STENSHORNE
  335. GOMMERUD 
  336. N-3320 VESTFOSSEN
  337. NORWAY
  338.  
  339. E-mail: mortens5@kihdata.kih.no
  340.